====== Extraire le tgz DokuWiki ======


[[:DokuWiki]] est disponible à travers une archive [[man>tar]] [[man>gzip]]'ée, appelée communément tgz ou tarball. Il s'agit d'un format d'archive courant dans le monde UNIX semblable au très populaire format Zip que beaucoup d'utilisateurs Windows connaissent. Cette page explique comment extraire un tel fichier sur divers systèmes d'exploitations.

===== Utilisateurs Unix/Linux =====

La majorité d'entre vous peut probablement exécuter la commande suivante :

  tar -xzvf dokuwiki-YYYY-MM-DD.tgz

Cela aura pour effet d'extraire le tarball dans un sous-répertoire nommé dokuwiki-YYYY-MM-DD.

Alternativement, vous pouvez extraire l'archive dans le répertoire courant en choisissant d'écraser les fichiers existants :

  tar -xzvf dokuwiki-YYYY-MM-DD.tgz --strip-components=1

==== Systèmes *nix moins communs ====

Sur certains systèmes non-Linux, vous devriez trouver le programme GNU [[man>tar]] sous le nom ''gtar'', aussi utilisez :

  gtar -xzvf dokuwiki-YYYY-MM-DD.tgz


Si cela ne fonctionne pas pour vous parce que vous êtes sur un système Unix propriétaire, ce qui suit devrait fonctionner (mais vous savez probablement quelle est la meilleure solution ;-) ):


  cat dokuwiki-YYYY-MM-DD.tgz |gzip -d | tar -xf -


===== Utilisateurs de Microsoft Windows =====


Les utilisateurs Windows peuvent avoir besoin de renommer le fichier ''dokuwiki-YYYY-MM-DD.tgz'' en ''dokuwiki-YYYY-MM-DD.tar.gz'' pour que leur utilitaire de désarchivage  reconnaisse correctement le type de fichier (voir le bogue [[bug>209]]).


Pour extraire le tarball, vous aurez besoin d'un utilitaire d'extraction. Il y a plusieurs centaines de programmes disponibles et il y a de grandes chance que vous en utilisiez déjà un. Sinon, voici une courte sélection :

  * [[http://www.7-zip.org|7-Zip]] gratuit et source ouverte
  * [[http://peazip.sourceforge.net/|PeaZip]] gratuit et source ouverte
  * [[http://www.izarc.org/|IZArc]] gratuiciel
  * [[http://www.tugzip.com|TUGZip]] gratuiciel
  * [[http://www.paehl.de/german.php|Simplyzip]] gratuiciel allemand
  * [[http://www.winzip.com|WinZIP]] Shareware
  * [[http://www.rarlab.com/|WinRAR]] Shareware
  * [[http://www.winace.com/|WinACE]] Shareware

Après avoir renommé comme indiqué ci-dessus, utilisez l'utilitaire d'extraction (par exemple 7-zip) pour extraire le fichier. Ceci créera le fichier ''dokuwiki-YYYY-MM-DD.tar'' qui sera relativement plus large que l'original. Une fois encore,  utilisez l'outil d'extraction (par exemple 7-zip) pour extraire ce fichier plus gros. Ceci créera un dossier ''dokuwiki-YYYY-MM-DD'' avec des fichiers et des sous-répertoires similaires à ce qui est déjà utilisé dans votre version courante.


===== Utilisateurs Mac =====

Normalement, un double-click sur l'archive suffit à la décompacter. Puisque Mac OS X possède un genre d'UNIX sous le capot, la description destinée à Unix/Linux ci-dessus fonctionne dans le Terminal.app. //StuffIt Expander//, version 8.02 et ultérieure manipule les .tagz correctement. Les versions antérieures de Stuffit Expander le devrait également.


===== Crédits de traduction =====
  * //[[trebmuh@tuxfamily.org|Olivier HUMBERT]] 2015/11/03//
  * //[[nicolas.chouali@laposte.net|Nicolas CHOUALI]] 2008/10/30//